library(tidyverse)     # for graphing and data cleaning
## -- Attaching packages -------------------------- tidyverse 1.3.0 --
## v ggplot2 3.3.2     v purrr   0.3.4
## v tibble  3.0.3     v dplyr   1.0.2
## v tidyr   1.1.2     v stringr 1.4.0
## v readr   1.3.1     v forcats 0.5.0
## -- Conflicts ----------------------------- tidyverse_conflicts() --
## x dplyr::filter() masks stats::filter()
## x dplyr::lag()    masks stats::lag()
library(googlesheets4) # for reading googlesheet data
library(lubridate)     # for date manipulation
## 
## Attaching package: 'lubridate'
## The following objects are masked from 'package:base':
## 
##     date, intersect, setdiff, union
library(ggthemes)      # for even more plotting themes
library(geofacet)      # for special faceting with US map layout
gs4_deauth()           # To not have to authorize each time you knit.
theme_set(theme_minimal())       # My favorite ggplot() theme :)
#Lisa's garden data
garden_harvest <- read_sheet("https://docs.google.com/spreadsheets/d/1DekSazCzKqPS2jnGhKue7tLxRU3GVL1oxi-4bEM5IWw/edit?usp=sharing") %>% 
  mutate(date = ymd(date))
## Reading from "2020_harvest"
## Range "Sheet1"
# Seeds/plants (and other garden supply) costs
supply_costs <- read_sheet("https://docs.google.com/spreadsheets/d/1dPVHwZgR9BxpigbHLnA0U99TtVHHQtUzNB9UR0wvb7o/edit?usp=sharing",
  col_types = "ccccnn")
## Reading from "2020_seeds"
## Range "Sheet1"
# Planting dates and locations
plant_date_loc <- read_sheet("https://docs.google.com/spreadsheets/d/11YH0NtXQTncQbUse5wOsTtLSKAiNogjUA21jnX5Pnl4/edit?usp=sharing",
  col_types = "cccnDlc")%>% 
  mutate(date = ymd(date))
## Reading from "seeds_planted"
## Range "Sheet1"
## Warning in .Primitive("as.double")(x, ...): NAs introduced by coercion
# Tidy Tuesday data
kids <- readr::read_csv('https://raw.githubusercontent.com/rfordatascience/tidytuesday/master/data/2020/2020-09-15/kids.csv')
## Parsed with column specification:
## cols(
##   state = col_character(),
##   variable = col_character(),
##   year = col_double(),
##   raw = col_double(),
##   inf_adj = col_double(),
##   inf_adj_perchild = col_double()
## )

Setting up on GitHub!

Before starting your assignment, you need to get yourself set up on GitHub and make sure GitHub is connected to R Studio. To do that, you should read the instruction (through the “Cloning a repo” section) and watch the video here. Then, do the following (if you get stuck on a step, don’t worry, I will help! You can always get started on the homework and we can figure out the GitHub piece later):

  • Create a repository on GitHub, giving it a nice name so you know it is for the 3rd weekly exercise assignment (follow the instructions in the document/video).
  • Copy the repo name so you can clone it to your computer. In R Studio, go to file –> New project –> Version control –> Git and follow the instructions from the document/video.
  • Download the code from this document and save it in the repository folder/project on your computer.
  • In R Studio, you should then see the .Rmd file in the upper right corner in the Git tab (along with the .Rproj file and probably .gitignore).
  • Check all the boxes of the files in the Git tab and choose commit.
  • In the commit window, write a commit message, something like “Initial upload” would be appropriate, and commit the files.
  • Either click the green up arrow in the commit window or close the commit window and click the green up arrow in the Git tab to push your changes to GitHub.
  • Refresh your GitHub page (online) and make sure the new documents have been pushed out.
  • Back in R Studio, knit the .Rmd file. When you do that, you should have two (as long as you didn’t make any changes to the .Rmd file, in which case you might have three) files show up in the Git tab - an .html file and an .md file. The .md file is something we haven’t seen before and is here because I included keep_md: TRUE in the YAML heading. The .md file is a markdown (NOT R Markdown) file that is an interim step to creating the html file. They are displayed fairly nicely in GitHub, so we want to keep it and look at it there. Click the boxes next to these two files, commit changes (remember to include a commit message), and push them (green up arrow).
  • As you work through your homework, save and commit often, push changes occasionally (maybe after you feel finished with an exercise?), and go check to see what the .md file looks like on GitHub.
  • If you have issues, let me know! This is new to many of you and may not be intuitive at first. But, I promise, you’ll get the hang of it!

Instructions

  • Put your name at the top of the document.

  • For ALL graphs, you should include appropriate labels.

  • Feel free to change the default theme, which I currently have set to theme_minimal().

  • Use good coding practice. Read the short sections on good code with pipes and ggplot2. This is part of your grade!

  • When you are finished with ALL the exercises, uncomment the options at the top so your document looks nicer. Don’t do it before then, or else you might miss some important warnings and messages.

Warm-up exercises with garden data

These exercises will reiterate what you learned in the “Expanding the data wrangling toolkit” tutorial. If you haven’t gone through the tutorial yet, you should do that first.

  1. Summarize the garden_harvest data to find the total harvest weight in pounds for each vegetable and day of week. Display the results so that the vegetables are rows but the days of the week are columns.
garden_harvest %>% 
  mutate(weight_lbs = weight*0.00220462) %>% 
  mutate(day = weekdays(date)) %>% 
  group_by(vegetable, day) %>% 
  summarise(veg_sum = sum(weight_lbs)) %>% 
  pivot_wider(id_cols = vegetable,
              names_from = day,
              values_from = veg_sum)
## `summarise()` regrouping output by 'vegetable' (override with `.groups` argument)
  1. Summarize the garden_harvest data to find the total harvest in pound for each vegetable variety and then try adding the plot variable from the plant_date_loc table. This will not turn out perfectly. What is the problem? How might you fix it?
#garden_harvest %>% 
  #mutate(wt_lbs = weight*0.00220462) %>% 
  #group_by(vegetable, variety) %>% 
  #summarise(veg_sum = sum(wt_lbs)) %>% 
  #left_join(plant_date_loc,
             #by = "plot")
  1. I would like to understand how much money I “saved” by gardening, for each vegetable type. Describe how I could use the garden_harvest and supply_cost datasets, along with data from somewhere like this to answer this question. You can answer this in words, referencing various join functions. You don’t need R code but could provide some if it’s helpful. First, you could group_by vegetable and variety in the garden_harvest dataset. Then you would mutate weight into wt_lbs. Then you would summarize the sum of the weights for each vegetable (named sum_wt_lbs). Then, you would left_join price_w_tax from the supply_costs dataset. You would end up with a table that has the variables vegetable, variety, sum_wt_lbs, and price w tax. Then you could manually calculate and compare the prices you paid for the amount (lbs) of vegetables you harvested vs the price you would have paid for the same amount (lbs) of vegetables at a Whole Foods.

  2. Subset the data to tomatoes. Reorder the tomato varieties from smallest to largest first harvest date. Create a barplot of total harvest in pounds for each variety, in the new order.

garden_harvest %>% 
  filter(vegetable %in% c("tomatoes")) %>% 
  mutate(wt_lbs = weight*0.00220462) %>% 
  group_by(variety) %>% 
  summarize(min_date = min(date), sum_wt = sum(wt_lbs)) %>% 
  arrange(min_date) %>% 
  mutate(variety = fct_reorder(variety, min_date)) %>% 
    ggplot(aes(y = variety,
             x = sum_wt,)) +
  geom_col()
## `summarise()` ungrouping output (override with `.groups` argument)

  1. In the garden_harvest data, create two new variables: one that makes the varieties lowercase and another that finds the length of the variety name. Arrange the data by vegetable and length of variety name (smallest to largest), with one row for each vegetable variety. HINT: use str_to_lower(), str_length(), and distinct().
garden_harvest %>% 
  mutate(variety_lower = str_to_lower(variety), 
         variety_length = str_length(variety)) %>% 
  distinct(vegetable, variety, variety_length) %>% 
  arrange(variety_length)
  1. In the garden_harvest data, find all distinct vegetable varieties that have “er” or “ar” in their name. HINT: str_detect() with an “or” statement (use the | for “or”) and distinct().
garden_harvest %>% 
  mutate(has_er_or_ar = str_detect(variety, "er|or")) %>% 
  distinct(vegetable, variety, has_er_or_ar) %>% 
  filter(has_er_or_ar == TRUE)

Bicycle-Use Patterns

In this activity, you’ll examine some factors that may influence the use of bicycles in a bike-renting program. The data come from Washington, DC and cover the last quarter of 2014.

A typical Capital Bikeshare station. This one is at Florida and California, next to Pleasant Pops.{300px}

One of the vans used to redistribute bicycles to different stations.{300px}

Two data tables are available:

  • Trips contains records of individual rentals
  • Stations gives the locations of the bike rental stations

Here is the code to read in the data. We do this a little differently than usualy, which is why it is included here rather than at the top of this file. To avoid repeatedly re-reading the files, start the data import chunk with {r cache = TRUE} rather than the usual {r}.

data_site <- 
  "https://www.macalester.edu/~dshuman1/data/112/2014-Q4-Trips-History-Data.rds" 
Trips <- readRDS(gzcon(url(data_site)))
Stations<-read_csv("http://www.macalester.edu/~dshuman1/data/112/DC-Stations.csv")
## Parsed with column specification:
## cols(
##   name = col_character(),
##   lat = col_double(),
##   long = col_double(),
##   nbBikes = col_double(),
##   nbEmptyDocks = col_double()
## )

NOTE: The Trips data table is a random subset of 10,000 trips from the full quarterly data. Start with this small data table to develop your analysis commands. When you have this working well, you should access the full data set of more than 600,000 events by removing -Small from the name of the data_site.

Temporal patterns

It’s natural to expect that bikes are rented more at some times of day, some days of the week, some months of the year than others. The variable sdate gives the time (including the date) that the rental started. Make the following plots and interpret them:

  1. A density plot, which is a smoothed out histogram, of the events versus sdate. Use geom_density().
Trips %>% 
  ggplot(aes(x = sdate))+
  geom_density()

  1. A density plot of the events versus time of day. You can use mutate() with lubridate’s hour() and minute() functions to extract the hour of the day and minute within the hour from sdate. Hint: A minute is 1/60 of an hour, so create a variable where 3:30 is 3.5 and 3:45 is 3.75.
Trips %>%
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour + minute/60) %>% 
  ggplot(aes(x= time_of_day))+
  geom_density()

  1. A bar graph of the events versus day of the week. Put day on the y-axis.
Trips %>% 
  mutate(day = weekdays(sdate)) %>% 
  ggplot(aes(y=day))+
  geom_bar()

  1. Facet your graph from exercise 8. by day of the week. Is there a pattern?
Trips %>%
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour + minute/60,
         day = weekdays(sdate)) %>% 
  ggplot(aes(x= time_of_day))+
  geom_density()+
  facet_wrap(vars(day))

On saturday and sunday, there is more activity during the middle of the day, vs the weekdays have a lull in business during that same time

The variable client describes whether the renter is a regular user (level Registered) or has not joined the bike-rental organization (Causal). The next set of exercises investigate whether these two different categories of users show different rental behavior and how client interacts with the patterns you found in the previous exercises. Repeat the graphic from Exercise @ref(exr:exr-temp) (d) with the following changes:

  1. Change the graph from exercise 10 to set the fill aesthetic for geom_density() to the client variable. You should also set alpha = .5 for transparency and color=NA to suppress the outline of the density function.
Trips %>%
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour + minute/60,
         day = weekdays(sdate)) %>% 
  ggplot(aes(x= time_of_day, fill = client, alpha = .5))+
  geom_density(color = NA)+
  facet_wrap(vars(day))

  1. Change the previous graph by adding the argument position = position_stack() to geom_density(). In your opinion, is this better or worse in terms of telling a story? What are the advantages/disadvantages of each?
Trips %>%
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour + minute/60,
         day = weekdays(sdate)) %>% 
  ggplot(aes(x= time_of_day, fill = client, alpha = .5))+
  geom_density(color = NA, position = position_stack())+
  facet_wrap(vars(day))

** 13. Add a new variable to the dataset called weekend which will be “weekend” if the day is Saturday or Sunday and “weekday” otherwise (HINT: use the ifelse() function and the wday() function from lubridate). Then, update the graph from the previous problem by faceting on the new weekend variable.

Trips %>% 
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour(sdate) + minute/60,
      week_day = wday(sdate, label = TRUE),
      weekend = ifelse(week_day == c("Sat", "Sun"),   "Weekend","Weekday" )) %>% 
  ggplot(aes(x = time_of_day, fill = client, alpha = .5))+
  geom_density(color = NA)+
  facet_wrap(vars(weekend))
## Warning: Problem with `mutate()` input `weekend`.
## i longer object length is not a multiple of shorter object length
## i Input `weekend` is `ifelse(week_day == c("Sat", "Sun"), "Weekend", "Weekday")`.
## Warning in `==.default`(week_day, c("Sat", "Sun")): longer object length is not
## a multiple of shorter object length
## Warning: Problem with `mutate()` input `weekend`.
## i longer object length is not a multiple of shorter object length
## i Input `weekend` is `ifelse(week_day == c("Sat", "Sun"), "Weekend", "Weekday")`.
## Warning in is.na(e1) | is.na(e2): longer object length is not a multiple of
## shorter object length

  1. Change the graph from the previous problem to facet on client and fill with weekday. What information does this graph tell you that the previous didn’t? Is one graph better than the other?
Trips %>% 
  mutate(hour = hour(sdate), minute = minute(sdate),
         time_of_day = hour(sdate) + minute/60,
      week_day = wday(sdate, label = TRUE),
      weekend = ifelse(week_day == c("Sat", "Sun"),   "Weekend","Weekday" )) %>% 
  ggplot(aes(x = time_of_day, fill = week_day, alpha = .5))+
  geom_density(color = NA)+
  facet_wrap(vars(client))
## Warning: Problem with `mutate()` input `weekend`.
## i longer object length is not a multiple of shorter object length
## i Input `weekend` is `ifelse(week_day == c("Sat", "Sun"), "Weekend", "Weekday")`.
## Warning in `==.default`(week_day, c("Sat", "Sun")): longer object length is not
## a multiple of shorter object length
## Warning: Problem with `mutate()` input `weekend`.
## i longer object length is not a multiple of shorter object length
## i Input `weekend` is `ifelse(week_day == c("Sat", "Sun"), "Weekend", "Weekday")`.
## Warning in is.na(e1) | is.na(e2): longer object length is not a multiple of
## shorter object length

** This graph tells us the specific day in which casual/registered renters rent a bike, where the previous graph gave us general ‘weekend’ and ‘weekday’. The second graph is a bit hard to read since the colors are all muddled together, but I think it depends on how specific you want your data to be presented. I would use both of these graphs, but perhaps for different questions.**

Spatial patterns

  1. Use the latitude and longitude variables in Stations to make a visualization of the total number of departures from each station in the Trips data. Use either color or size to show the variation in number of departures. We will improve this plot next week when we learn about maps!
Stations %>% 
  left_join(Trips,
            by = c("name" = "sstation")) %>% 
  group_by(name,long, lat) %>% 
  summarize(count = n()) %>% 
  ggplot(aes(x = lat, y = long, color = count, size = count))+
  geom_point()
## `summarise()` regrouping output by 'name', 'long' (override with `.groups` argument)

  1. Only 14.4% of the trips in our data are carried out by casual users. Create a plot that shows which area(s) have stations with a much higher percentage of departures by casual users. What patterns do you notice? (Again, we’ll improve this next week when we learn about maps).
Stations %>% 
  left_join(Trips,
            by = c("name" = "sstation")) %>% 
  group_by(name, long, lat) %>% 
  summarize(percent_casual = mean(client == "Casual")) %>% 
  ggplot(aes(x = long, 
             y = lat, 
             color = percent_casual))+
  geom_point()
## `summarise()` regrouping output by 'name', 'long' (override with `.groups` argument)

Spatiotemporal patterns

  1. Make a table with the ten station-date combinations (e.g., 14th & V St., 2014-10-14) with the highest number of departures, sorted from most departures to fewest. Save this to a new dataset and print out the dataset. Hint: as_date(sdate) converts sdate from date-time format to date format.
top_stations <- Stations %>% 
  left_join(Trips,
            by = c("name" = "sstation")) %>% 
  mutate(sdate = as_date(sdate)) %>% 
  group_by(name, sdate) %>% 
  summarize(count = n()) %>% 
  arrange(desc(count)) %>% 
  head(n = 10)
## `summarise()` regrouping output by 'name' (override with `.groups` argument)
  1. Use a join operation to make a table with only those trips whose departures match those top ten station-date combinations from the previous part.
top_stations %>% 
  inner_join(Trips,
             by = c("name" = "sstation"))
  1. Build on the code from the previous problem (ie. copy that code below and then %>% into the next step.) and group the trips by client type and day of the week (use the name, not the number). Find the proportion of trips by day within each client type (ie. the proportions for all 7 days within each client type add up to 1). Display your results so day of week is a column and there is a column for each client type. Interpret your results. I’m sorry, I didn’t know how to do #18, so this question tripped me up as well.

DID YOU REMEMBER TO GO BACK AND CHANGE THIS SET OF EXERCISES TO THE LARGER DATASET? IF NOT, DO THAT NOW.

Challenge problem!

This problem uses the data from the Tidy Tuesday competition this week, kids. If you need to refresh your memory on the data, read about it here.

  1. In this exercise, you are going to try to replicate the graph below, created by Georgios Karamanis. I’m sure you can find the exact code on GitHub somewhere, but DON’T DO THAT! You will only be graded for putting an effort into this problem. So, give it a try and see how far you can get without doing too much googling. HINT: use facet_geo(). The graphic won’t load below since it came from a location on my computer. So, you’ll have to reference the original html on the moodle page to see it.

DID YOU REMEMBER TO UNCOMMENT THE OPTIONS AT THE TOP?

LS0tDQp0aXRsZTogJ1dlZWtseSBFeGVyY2lzZXMgIzMnDQphdXRob3I6ICJDaGV5ZW5uZSBXb2VybWFuIg0Kb3V0cHV0OiANCiAgaHRtbF9kb2N1bWVudDoNCiAgICBrZWVwX21kOiBUUlVFDQogICAgdG9jOiBUUlVFDQogICAgdG9jX2Zsb2F0OiBUUlVFDQogICAgZGZfcHJpbnQ6IHBhZ2VkDQogICAgY29kZV9kb3dubG9hZDogdHJ1ZQ0KLS0tDQoNCg0KYGBge3Igc2V0dXAsIGluY2x1ZGU9RkFMU0V9DQoja25pdHI6Om9wdHNfY2h1bmskc2V0KGVjaG8gPSBUUlVFLCBlcnJvcj1UUlVFLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFKQ0KYGBgDQoNCmBgYHtyIGxpYnJhcmllc30NCmxpYnJhcnkodGlkeXZlcnNlKSAgICAgIyBmb3IgZ3JhcGhpbmcgYW5kIGRhdGEgY2xlYW5pbmcNCmxpYnJhcnkoZ29vZ2xlc2hlZXRzNCkgIyBmb3IgcmVhZGluZyBnb29nbGVzaGVldCBkYXRhDQpsaWJyYXJ5KGx1YnJpZGF0ZSkgICAgICMgZm9yIGRhdGUgbWFuaXB1bGF0aW9uDQpsaWJyYXJ5KGdndGhlbWVzKSAgICAgICMgZm9yIGV2ZW4gbW9yZSBwbG90dGluZyB0aGVtZXMNCmxpYnJhcnkoZ2VvZmFjZXQpICAgICAgIyBmb3Igc3BlY2lhbCBmYWNldGluZyB3aXRoIFVTIG1hcCBsYXlvdXQNCmdzNF9kZWF1dGgoKSAgICAgICAgICAgIyBUbyBub3QgaGF2ZSB0byBhdXRob3JpemUgZWFjaCB0aW1lIHlvdSBrbml0Lg0KdGhlbWVfc2V0KHRoZW1lX21pbmltYWwoKSkgICAgICAgIyBNeSBmYXZvcml0ZSBnZ3Bsb3QoKSB0aGVtZSA6KQ0KYGBgDQoNCmBgYHtyIGRhdGF9DQojTGlzYSdzIGdhcmRlbiBkYXRhDQpnYXJkZW5faGFydmVzdCA8LSByZWFkX3NoZWV0KCJodHRwczovL2RvY3MuZ29vZ2xlLmNvbS9zcHJlYWRzaGVldHMvZC8xRGVrU2F6Q3pLcVBTMmpuR2hLdWU3dEx4UlUzR1ZMMW94aS00YkVNNUlXdy9lZGl0P3VzcD1zaGFyaW5nIikgJT4lIA0KICBtdXRhdGUoZGF0ZSA9IHltZChkYXRlKSkNCg0KIyBTZWVkcy9wbGFudHMgKGFuZCBvdGhlciBnYXJkZW4gc3VwcGx5KSBjb3N0cw0Kc3VwcGx5X2Nvc3RzIDwtIHJlYWRfc2hlZXQoImh0dHBzOi8vZG9jcy5nb29nbGUuY29tL3NwcmVhZHNoZWV0cy9kLzFkUFZId1pnUjlCeHBpZ2JITG5BMFU5OVR0VkhIUXRVek5COVVSMHd2YjdvL2VkaXQ/dXNwPXNoYXJpbmciLA0KICBjb2xfdHlwZXMgPSAiY2NjY25uIikNCg0KIyBQbGFudGluZyBkYXRlcyBhbmQgbG9jYXRpb25zDQpwbGFudF9kYXRlX2xvYyA8LSByZWFkX3NoZWV0KCJodHRwczovL2RvY3MuZ29vZ2xlLmNvbS9zcHJlYWRzaGVldHMvZC8xMVlIME50WFFUbmNRYlVzZTV3T3NUdExTS0FpTm9nalVBMjFqblg1UG5sNC9lZGl0P3VzcD1zaGFyaW5nIiwNCiAgY29sX3R5cGVzID0gImNjY25EbGMiKSU+JSANCiAgbXV0YXRlKGRhdGUgPSB5bWQoZGF0ZSkpDQoNCiMgVGlkeSBUdWVzZGF5IGRhdGENCmtpZHMgPC0gcmVhZHI6OnJlYWRfY3N2KCdodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vcmZvcmRhdGFzY2llbmNlL3RpZHl0dWVzZGF5L21hc3Rlci9kYXRhLzIwMjAvMjAyMC0wOS0xNS9raWRzLmNzdicpDQpgYGANCg0KIyMgU2V0dGluZyB1cCBvbiBHaXRIdWIhDQoNCkJlZm9yZSBzdGFydGluZyB5b3VyIGFzc2lnbm1lbnQsIHlvdSBuZWVkIHRvIGdldCB5b3Vyc2VsZiBzZXQgdXAgb24gR2l0SHViIGFuZCBtYWtlIHN1cmUgR2l0SHViIGlzIGNvbm5lY3RlZCB0byBSIFN0dWRpby4gVG8gZG8gdGhhdCwgeW91IHNob3VsZCByZWFkIHRoZSBpbnN0cnVjdGlvbiAodGhyb3VnaCB0aGUgIkNsb25pbmcgYSByZXBvIiBzZWN0aW9uKSBhbmQgd2F0Y2ggdGhlIHZpZGVvIFtoZXJlXShodHRwczovL2dpdGh1Yi5jb20vbGxlbmR3YXkvZ2l0aHViX2Zvcl9jb2xsYWJvcmF0aW9uL2Jsb2IvbWFzdGVyL2dpdGh1Yl9mb3JfY29sbGFib3JhdGlvbi5tZCkuIFRoZW4sIGRvIHRoZSBmb2xsb3dpbmcgKGlmIHlvdSBnZXQgc3R1Y2sgb24gYSBzdGVwLCBkb24ndCB3b3JyeSwgSSB3aWxsIGhlbHAhIFlvdSBjYW4gYWx3YXlzIGdldCBzdGFydGVkIG9uIHRoZSBob21ld29yayBhbmQgd2UgY2FuIGZpZ3VyZSBvdXQgdGhlIEdpdEh1YiBwaWVjZSBsYXRlcik6DQoNCiogQ3JlYXRlIGEgcmVwb3NpdG9yeSBvbiBHaXRIdWIsIGdpdmluZyBpdCBhIG5pY2UgbmFtZSBzbyB5b3Uga25vdyBpdCBpcyBmb3IgdGhlIDNyZCB3ZWVrbHkgZXhlcmNpc2UgYXNzaWdubWVudCAoZm9sbG93IHRoZSBpbnN0cnVjdGlvbnMgaW4gdGhlIGRvY3VtZW50L3ZpZGVvKS4gIA0KKiBDb3B5IHRoZSByZXBvIG5hbWUgc28geW91IGNhbiBjbG9uZSBpdCB0byB5b3VyIGNvbXB1dGVyLiBJbiBSIFN0dWRpbywgZ28gdG8gZmlsZSAtLT4gTmV3IHByb2plY3QgLS0+IFZlcnNpb24gY29udHJvbCAtLT4gR2l0IGFuZCBmb2xsb3cgdGhlIGluc3RydWN0aW9ucyBmcm9tIHRoZSBkb2N1bWVudC92aWRlby4gIA0KKiBEb3dubG9hZCB0aGUgY29kZSBmcm9tIHRoaXMgZG9jdW1lbnQgYW5kIHNhdmUgaXQgaW4gdGhlIHJlcG9zaXRvcnkgZm9sZGVyL3Byb2plY3Qgb24geW91ciBjb21wdXRlci4gIA0KKiBJbiBSIFN0dWRpbywgeW91IHNob3VsZCB0aGVuIHNlZSB0aGUgLlJtZCBmaWxlIGluIHRoZSB1cHBlciByaWdodCBjb3JuZXIgaW4gdGhlIEdpdCB0YWIgKGFsb25nIHdpdGggdGhlIC5ScHJvaiBmaWxlIGFuZCBwcm9iYWJseSAuZ2l0aWdub3JlKS4gIA0KKiBDaGVjayBhbGwgdGhlIGJveGVzIG9mIHRoZSBmaWxlcyBpbiB0aGUgR2l0IHRhYiBhbmQgY2hvb3NlIGNvbW1pdC4gIA0KKiBJbiB0aGUgY29tbWl0IHdpbmRvdywgd3JpdGUgYSBjb21taXQgbWVzc2FnZSwgc29tZXRoaW5nIGxpa2UgIkluaXRpYWwgdXBsb2FkIiB3b3VsZCBiZSBhcHByb3ByaWF0ZSwgYW5kIGNvbW1pdCB0aGUgZmlsZXMuICANCiogRWl0aGVyIGNsaWNrIHRoZSBncmVlbiB1cCBhcnJvdyBpbiB0aGUgY29tbWl0IHdpbmRvdyBvciBjbG9zZSB0aGUgY29tbWl0IHdpbmRvdyBhbmQgY2xpY2sgdGhlIGdyZWVuIHVwIGFycm93IGluIHRoZSBHaXQgdGFiIHRvIHB1c2ggeW91ciBjaGFuZ2VzIHRvIEdpdEh1Yi4gIA0KKiBSZWZyZXNoIHlvdXIgR2l0SHViIHBhZ2UgKG9ubGluZSkgYW5kIG1ha2Ugc3VyZSB0aGUgbmV3IGRvY3VtZW50cyBoYXZlIGJlZW4gcHVzaGVkIG91dC4gIA0KKiBCYWNrIGluIFIgU3R1ZGlvLCBrbml0IHRoZSAuUm1kIGZpbGUuIFdoZW4geW91IGRvIHRoYXQsIHlvdSBzaG91bGQgaGF2ZSB0d28gKGFzIGxvbmcgYXMgeW91IGRpZG4ndCBtYWtlIGFueSBjaGFuZ2VzIHRvIHRoZSAuUm1kIGZpbGUsIGluIHdoaWNoIGNhc2UgeW91IG1pZ2h0IGhhdmUgdGhyZWUpIGZpbGVzIHNob3cgdXAgaW4gdGhlIEdpdCB0YWIgLSBhbiAuaHRtbCBmaWxlIGFuZCBhbiAubWQgZmlsZS4gVGhlIC5tZCBmaWxlIGlzIHNvbWV0aGluZyB3ZSBoYXZlbid0IHNlZW4gYmVmb3JlIGFuZCBpcyBoZXJlIGJlY2F1c2UgSSBpbmNsdWRlZCBga2VlcF9tZDogVFJVRWAgaW4gdGhlIFlBTUwgaGVhZGluZy4gVGhlIC5tZCBmaWxlIGlzIGEgbWFya2Rvd24gKE5PVCBSIE1hcmtkb3duKSBmaWxlIHRoYXQgaXMgYW4gaW50ZXJpbSBzdGVwIHRvIGNyZWF0aW5nIHRoZSBodG1sIGZpbGUuIFRoZXkgYXJlIGRpc3BsYXllZCBmYWlybHkgbmljZWx5IGluIEdpdEh1Yiwgc28gd2Ugd2FudCB0byBrZWVwIGl0IGFuZCBsb29rIGF0IGl0IHRoZXJlLiBDbGljayB0aGUgYm94ZXMgbmV4dCB0byB0aGVzZSB0d28gZmlsZXMsIGNvbW1pdCBjaGFuZ2VzIChyZW1lbWJlciB0byBpbmNsdWRlIGEgY29tbWl0IG1lc3NhZ2UpLCBhbmQgcHVzaCB0aGVtIChncmVlbiB1cCBhcnJvdykuICANCiogQXMgeW91IHdvcmsgdGhyb3VnaCB5b3VyIGhvbWV3b3JrLCBzYXZlIGFuZCBjb21taXQgb2Z0ZW4sIHB1c2ggY2hhbmdlcyBvY2Nhc2lvbmFsbHkgKG1heWJlIGFmdGVyIHlvdSBmZWVsIGZpbmlzaGVkIHdpdGggYW4gZXhlcmNpc2U/KSwgYW5kIGdvIGNoZWNrIHRvIHNlZSB3aGF0IHRoZSAubWQgZmlsZSBsb29rcyBsaWtlIG9uIEdpdEh1Yi4gIA0KKiBJZiB5b3UgaGF2ZSBpc3N1ZXMsIGxldCBtZSBrbm93ISBUaGlzIGlzIG5ldyB0byBtYW55IG9mIHlvdSBhbmQgbWF5IG5vdCBiZSBpbnR1aXRpdmUgYXQgZmlyc3QuIEJ1dCwgSSBwcm9taXNlLCB5b3UnbGwgZ2V0IHRoZSBoYW5nIG9mIGl0ISANCg0KDQoNCiMjIEluc3RydWN0aW9ucw0KDQoqIFB1dCB5b3VyIG5hbWUgYXQgdGhlIHRvcCBvZiB0aGUgZG9jdW1lbnQuIA0KDQoqICoqRm9yIEFMTCBncmFwaHMsIHlvdSBzaG91bGQgaW5jbHVkZSBhcHByb3ByaWF0ZSBsYWJlbHMuKiogDQoNCiogRmVlbCBmcmVlIHRvIGNoYW5nZSB0aGUgZGVmYXVsdCB0aGVtZSwgd2hpY2ggSSBjdXJyZW50bHkgaGF2ZSBzZXQgdG8gYHRoZW1lX21pbmltYWwoKWAuIA0KDQoqIFVzZSBnb29kIGNvZGluZyBwcmFjdGljZS4gUmVhZCB0aGUgc2hvcnQgc2VjdGlvbnMgb24gZ29vZCBjb2RlIHdpdGggW3BpcGVzXShodHRwczovL3N0eWxlLnRpZHl2ZXJzZS5vcmcvcGlwZXMuaHRtbCkgYW5kIFtnZ3Bsb3QyXShodHRwczovL3N0eWxlLnRpZHl2ZXJzZS5vcmcvZ2dwbG90Mi5odG1sKS4gKipUaGlzIGlzIHBhcnQgb2YgeW91ciBncmFkZSEqKg0KDQoqIFdoZW4geW91IGFyZSBmaW5pc2hlZCB3aXRoIEFMTCB0aGUgZXhlcmNpc2VzLCB1bmNvbW1lbnQgdGhlIG9wdGlvbnMgYXQgdGhlIHRvcCBzbyB5b3VyIGRvY3VtZW50IGxvb2tzIG5pY2VyLiBEb24ndCBkbyBpdCBiZWZvcmUgdGhlbiwgb3IgZWxzZSB5b3UgbWlnaHQgbWlzcyBzb21lIGltcG9ydGFudCB3YXJuaW5ncyBhbmQgbWVzc2FnZXMuDQoNCg0KIyMgV2FybS11cCBleGVyY2lzZXMgd2l0aCBnYXJkZW4gZGF0YQ0KDQpUaGVzZSBleGVyY2lzZXMgd2lsbCByZWl0ZXJhdGUgd2hhdCB5b3UgbGVhcm5lZCBpbiB0aGUgIkV4cGFuZGluZyB0aGUgZGF0YSB3cmFuZ2xpbmcgdG9vbGtpdCIgdHV0b3JpYWwuIElmIHlvdSBoYXZlbid0IGdvbmUgdGhyb3VnaCB0aGUgdHV0b3JpYWwgeWV0LCB5b3Ugc2hvdWxkIGRvIHRoYXQgZmlyc3QuDQoNCiAgMS4gU3VtbWFyaXplIHRoZSBgZ2FyZGVuX2hhcnZlc3RgIGRhdGEgdG8gZmluZCB0aGUgdG90YWwgaGFydmVzdCB3ZWlnaHQgaW4gcG91bmRzIGZvciBlYWNoIHZlZ2V0YWJsZSBhbmQgZGF5IG9mIHdlZWsuIERpc3BsYXkgdGhlIHJlc3VsdHMgc28gdGhhdCB0aGUgdmVnZXRhYmxlcyBhcmUgcm93cyBidXQgdGhlIGRheXMgb2YgdGhlIHdlZWsgYXJlIGNvbHVtbnMuDQoNCmBgYHtyfQ0KZ2FyZGVuX2hhcnZlc3QgJT4lIA0KICBtdXRhdGUod2VpZ2h0X2xicyA9IHdlaWdodCowLjAwMjIwNDYyKSAlPiUgDQogIG11dGF0ZShkYXkgPSB3ZWVrZGF5cyhkYXRlKSkgJT4lIA0KICBncm91cF9ieSh2ZWdldGFibGUsIGRheSkgJT4lIA0KICBzdW1tYXJpc2UodmVnX3N1bSA9IHN1bSh3ZWlnaHRfbGJzKSkgJT4lIA0KICBwaXZvdF93aWRlcihpZF9jb2xzID0gdmVnZXRhYmxlLA0KICAgICAgICAgICAgICBuYW1lc19mcm9tID0gZGF5LA0KICAgICAgICAgICAgICB2YWx1ZXNfZnJvbSA9IHZlZ19zdW0pDQpgYGANCg0KICAyLiBTdW1tYXJpemUgdGhlIGBnYXJkZW5faGFydmVzdGAgZGF0YSB0byBmaW5kIHRoZSB0b3RhbCBoYXJ2ZXN0IGluIHBvdW5kIGZvciBlYWNoIHZlZ2V0YWJsZSB2YXJpZXR5IGFuZCB0aGVuIHRyeSBhZGRpbmcgdGhlIGBwbG90YCB2YXJpYWJsZSBmcm9tIHRoZSBgcGxhbnRfZGF0ZV9sb2NgIHRhYmxlLiBUaGlzIHdpbGwgbm90IHR1cm4gb3V0IHBlcmZlY3RseS4gV2hhdCBpcyB0aGUgcHJvYmxlbT8gSG93IG1pZ2h0IHlvdSBmaXggaXQ/DQoNCmBgYHtyfQ0KI2dhcmRlbl9oYXJ2ZXN0ICU+JSANCiAgI211dGF0ZSh3dF9sYnMgPSB3ZWlnaHQqMC4wMDIyMDQ2MikgJT4lIA0KICAjZ3JvdXBfYnkodmVnZXRhYmxlLCB2YXJpZXR5KSAlPiUgDQogICNzdW1tYXJpc2UodmVnX3N1bSA9IHN1bSh3dF9sYnMpKSAlPiUgDQogICNsZWZ0X2pvaW4ocGxhbnRfZGF0ZV9sb2MsDQogICAgICAgICAgICAgI2J5ID0gInBsb3QiKQ0KYGBgDQoNCiAgMy4gSSB3b3VsZCBsaWtlIHRvIHVuZGVyc3RhbmQgaG93IG11Y2ggbW9uZXkgSSAic2F2ZWQiIGJ5IGdhcmRlbmluZywgZm9yIGVhY2ggdmVnZXRhYmxlIHR5cGUuIERlc2NyaWJlIGhvdyBJIGNvdWxkIHVzZSB0aGUgYGdhcmRlbl9oYXJ2ZXN0YCBhbmQgYHN1cHBseV9jb3N0YCBkYXRhc2V0cywgYWxvbmcgd2l0aCBkYXRhIGZyb20gc29tZXdoZXJlIGxpa2UgW3RoaXNdKGh0dHBzOi8vcHJvZHVjdHMud2hvbGVmb29kc21hcmtldC5jb20vc2VhcmNoP3NvcnQ9cmVsZXZhbmNlJnN0b3JlPTEwNTQyKSB0byBhbnN3ZXIgdGhpcyBxdWVzdGlvbi4gWW91IGNhbiBhbnN3ZXIgdGhpcyBpbiB3b3JkcywgcmVmZXJlbmNpbmcgdmFyaW91cyBqb2luIGZ1bmN0aW9ucy4gWW91IGRvbid0IG5lZWQgUiBjb2RlIGJ1dCBjb3VsZCBwcm92aWRlIHNvbWUgaWYgaXQncyBoZWxwZnVsLg0KICAqKkZpcnN0LCB5b3UgY291bGQgZ3JvdXBfYnkgdmVnZXRhYmxlIGFuZCB2YXJpZXR5IGluIHRoZSBnYXJkZW5faGFydmVzdCBkYXRhc2V0LiBUaGVuIHlvdSB3b3VsZCBtdXRhdGUgd2VpZ2h0IGludG8gd3RfbGJzLiBUaGVuIHlvdSB3b3VsZCBzdW1tYXJpemUgdGhlIHN1bSBvZiB0aGUgd2VpZ2h0cyBmb3IgZWFjaCB2ZWdldGFibGUgKG5hbWVkIHN1bV93dF9sYnMpLiBUaGVuLCB5b3Ugd291bGQgbGVmdF9qb2luIHByaWNlX3dfdGF4IGZyb20gdGhlIHN1cHBseV9jb3N0cyBkYXRhc2V0LiBZb3Ugd291bGQgZW5kIHVwIHdpdGggYSB0YWJsZSB0aGF0IGhhcyB0aGUgdmFyaWFibGVzIHZlZ2V0YWJsZSwgdmFyaWV0eSwgc3VtX3d0X2xicywgYW5kIHByaWNlIHcgdGF4LiBUaGVuIHlvdSBjb3VsZCBtYW51YWxseSBjYWxjdWxhdGUgYW5kIGNvbXBhcmUgdGhlIHByaWNlcyB5b3UgcGFpZCBmb3IgdGhlIGFtb3VudCAobGJzKSBvZiB2ZWdldGFibGVzIHlvdSBoYXJ2ZXN0ZWQgdnMgdGhlIHByaWNlIHlvdSB3b3VsZCBoYXZlIHBhaWQgZm9yIHRoZSBzYW1lIGFtb3VudCAobGJzKSBvZiB2ZWdldGFibGVzIGF0IGEgV2hvbGUgRm9vZHMuKioNCg0KICA0LiBTdWJzZXQgdGhlIGRhdGEgdG8gdG9tYXRvZXMuIFJlb3JkZXIgdGhlIHRvbWF0byB2YXJpZXRpZXMgZnJvbSBzbWFsbGVzdCB0byBsYXJnZXN0IGZpcnN0IGhhcnZlc3QgZGF0ZS4gQ3JlYXRlIGEgYmFycGxvdCBvZiB0b3RhbCBoYXJ2ZXN0IGluIHBvdW5kcyBmb3IgZWFjaCB2YXJpZXR5LCBpbiB0aGUgbmV3IG9yZGVyLg0KDQpgYGB7cn0NCmdhcmRlbl9oYXJ2ZXN0ICU+JSANCiAgZmlsdGVyKHZlZ2V0YWJsZSAlaW4lIGMoInRvbWF0b2VzIikpICU+JSANCiAgbXV0YXRlKHd0X2xicyA9IHdlaWdodCowLjAwMjIwNDYyKSAlPiUgDQogIGdyb3VwX2J5KHZhcmlldHkpICU+JSANCiAgc3VtbWFyaXplKG1pbl9kYXRlID0gbWluKGRhdGUpLCBzdW1fd3QgPSBzdW0od3RfbGJzKSkgJT4lIA0KICBhcnJhbmdlKG1pbl9kYXRlKSAlPiUgDQogIG11dGF0ZSh2YXJpZXR5ID0gZmN0X3Jlb3JkZXIodmFyaWV0eSwgbWluX2RhdGUpKSAlPiUgDQogICAgZ2dwbG90KGFlcyh5ID0gdmFyaWV0eSwNCiAgICAgICAgICAgICB4ID0gc3VtX3d0LCkpICsNCiAgZ2VvbV9jb2woKQ0KYGBgDQoNCiAgNS4gSW4gdGhlIGBnYXJkZW5faGFydmVzdGAgZGF0YSwgY3JlYXRlIHR3byBuZXcgdmFyaWFibGVzOiBvbmUgdGhhdCBtYWtlcyB0aGUgdmFyaWV0aWVzIGxvd2VyY2FzZSBhbmQgYW5vdGhlciB0aGF0IGZpbmRzIHRoZSBsZW5ndGggb2YgdGhlIHZhcmlldHkgbmFtZS4gQXJyYW5nZSB0aGUgZGF0YSBieSB2ZWdldGFibGUgYW5kIGxlbmd0aCBvZiB2YXJpZXR5IG5hbWUgKHNtYWxsZXN0IHRvIGxhcmdlc3QpLCB3aXRoIG9uZSByb3cgZm9yIGVhY2ggdmVnZXRhYmxlIHZhcmlldHkuIEhJTlQ6IHVzZSBgc3RyX3RvX2xvd2VyKClgLCBgc3RyX2xlbmd0aCgpYCwgYW5kIGBkaXN0aW5jdCgpYC4NCiAgDQpgYGB7cn0NCmdhcmRlbl9oYXJ2ZXN0ICU+JSANCiAgbXV0YXRlKHZhcmlldHlfbG93ZXIgPSBzdHJfdG9fbG93ZXIodmFyaWV0eSksIA0KICAgICAgICAgdmFyaWV0eV9sZW5ndGggPSBzdHJfbGVuZ3RoKHZhcmlldHkpKSAlPiUgDQogIGRpc3RpbmN0KHZlZ2V0YWJsZSwgdmFyaWV0eSwgdmFyaWV0eV9sZW5ndGgpICU+JSANCiAgYXJyYW5nZSh2YXJpZXR5X2xlbmd0aCkNCmBgYA0KDQogIDYuIEluIHRoZSBgZ2FyZGVuX2hhcnZlc3RgIGRhdGEsIGZpbmQgYWxsIGRpc3RpbmN0IHZlZ2V0YWJsZSB2YXJpZXRpZXMgdGhhdCBoYXZlICJlciIgb3IgImFyIiBpbiB0aGVpciBuYW1lLiBISU5UOiBgc3RyX2RldGVjdCgpYCB3aXRoIGFuICJvciIgc3RhdGVtZW50ICh1c2UgdGhlIHwgZm9yICJvciIpIGFuZCBgZGlzdGluY3QoKWAuDQoNCmBgYHtyfQ0KZ2FyZGVuX2hhcnZlc3QgJT4lIA0KICBtdXRhdGUoaGFzX2VyX29yX2FyID0gc3RyX2RldGVjdCh2YXJpZXR5LCAiZXJ8b3IiKSkgJT4lIA0KICBkaXN0aW5jdCh2ZWdldGFibGUsIHZhcmlldHksIGhhc19lcl9vcl9hcikgJT4lIA0KICBmaWx0ZXIoaGFzX2VyX29yX2FyID09IFRSVUUpDQpgYGANCg0KDQojIyBCaWN5Y2xlLVVzZSBQYXR0ZXJucw0KDQpJbiB0aGlzIGFjdGl2aXR5LCB5b3UnbGwgZXhhbWluZSBzb21lIGZhY3RvcnMgdGhhdCBtYXkgaW5mbHVlbmNlIHRoZSB1c2Ugb2YgYmljeWNsZXMgaW4gYSBiaWtlLXJlbnRpbmcgcHJvZ3JhbS4gIFRoZSBkYXRhIGNvbWUgZnJvbSBXYXNoaW5ndG9uLCBEQyBhbmQgY292ZXIgdGhlIGxhc3QgcXVhcnRlciBvZiAyMDE0Lg0KDQo8Y2VudGVyPg0KDQohW0EgdHlwaWNhbCBDYXBpdGFsIEJpa2VzaGFyZSBzdGF0aW9uLiBUaGlzIG9uZSBpcyBhdCBGbG9yaWRhIGFuZCBDYWxpZm9ybmlhLCBuZXh0IHRvIFBsZWFzYW50IFBvcHMuXShodHRwczovL3d3dy5tYWNhbGVzdGVyLmVkdS9+ZHNodW1hbjEvZGF0YS8xMTIvYmlrZV9zdGF0aW9uLmpwZyl7MzAwcHh9DQoNCg0KIVtPbmUgb2YgdGhlIHZhbnMgdXNlZCB0byByZWRpc3RyaWJ1dGUgYmljeWNsZXMgdG8gZGlmZmVyZW50IHN0YXRpb25zLl0oaHR0cHM6Ly93d3cubWFjYWxlc3Rlci5lZHUvfmRzaHVtYW4xL2RhdGEvMTEyL2Jpa2VfdmFuLmpwZyl7MzAwcHh9DQoNCjwvY2VudGVyPg0KDQpUd28gZGF0YSB0YWJsZXMgYXJlIGF2YWlsYWJsZToNCg0KLSBgVHJpcHNgIGNvbnRhaW5zIHJlY29yZHMgb2YgaW5kaXZpZHVhbCByZW50YWxzDQotIGBTdGF0aW9uc2AgZ2l2ZXMgdGhlIGxvY2F0aW9ucyBvZiB0aGUgYmlrZSByZW50YWwgc3RhdGlvbnMNCg0KSGVyZSBpcyB0aGUgY29kZSB0byByZWFkIGluIHRoZSBkYXRhLiBXZSBkbyB0aGlzIGEgbGl0dGxlIGRpZmZlcmVudGx5IHRoYW4gdXN1YWx5LCB3aGljaCBpcyB3aHkgaXQgaXMgaW5jbHVkZWQgaGVyZSByYXRoZXIgdGhhbiBhdCB0aGUgdG9wIG9mIHRoaXMgZmlsZS4gVG8gYXZvaWQgcmVwZWF0ZWRseSByZS1yZWFkaW5nIHRoZSBmaWxlcywgc3RhcnQgdGhlIGRhdGEgaW1wb3J0IGNodW5rIHdpdGggYHtyIGNhY2hlID0gVFJVRX1gIHJhdGhlciB0aGFuIHRoZSB1c3VhbCBge3J9YC4NCg0KYGBge3IgY2FjaGU9VFJVRX0NCmRhdGFfc2l0ZSA8LSANCiAgImh0dHBzOi8vd3d3Lm1hY2FsZXN0ZXIuZWR1L35kc2h1bWFuMS9kYXRhLzExMi8yMDE0LVE0LVRyaXBzLUhpc3RvcnktRGF0YS5yZHMiIA0KVHJpcHMgPC0gcmVhZFJEUyhnemNvbih1cmwoZGF0YV9zaXRlKSkpDQpTdGF0aW9uczwtcmVhZF9jc3YoImh0dHA6Ly93d3cubWFjYWxlc3Rlci5lZHUvfmRzaHVtYW4xL2RhdGEvMTEyL0RDLVN0YXRpb25zLmNzdiIpDQpgYGANCg0KKipOT1RFOioqIFRoZSBgVHJpcHNgIGRhdGEgdGFibGUgaXMgYSByYW5kb20gc3Vic2V0IG9mIDEwLDAwMCB0cmlwcyBmcm9tIHRoZSBmdWxsIHF1YXJ0ZXJseSBkYXRhLiBTdGFydCB3aXRoIHRoaXMgc21hbGwgZGF0YSB0YWJsZSB0byBkZXZlbG9wIHlvdXIgYW5hbHlzaXMgY29tbWFuZHMuICoqV2hlbiB5b3UgaGF2ZSB0aGlzIHdvcmtpbmcgd2VsbCwgeW91IHNob3VsZCBhY2Nlc3MgdGhlIGZ1bGwgZGF0YSBzZXQgb2YgbW9yZSB0aGFuIDYwMCwwMDAgZXZlbnRzIGJ5IHJlbW92aW5nIGAtU21hbGxgIGZyb20gdGhlIG5hbWUgb2YgdGhlIGBkYXRhX3NpdGVgLioqDQoNCiMjIyBUZW1wb3JhbCBwYXR0ZXJucw0KDQpJdCdzIG5hdHVyYWwgdG8gZXhwZWN0IHRoYXQgYmlrZXMgYXJlIHJlbnRlZCBtb3JlIGF0IHNvbWUgdGltZXMgb2YgZGF5LCBzb21lIGRheXMgb2YgdGhlIHdlZWssIHNvbWUgbW9udGhzIG9mIHRoZSB5ZWFyIHRoYW4gb3RoZXJzLiBUaGUgdmFyaWFibGUgYHNkYXRlYCBnaXZlcyB0aGUgdGltZSAoaW5jbHVkaW5nIHRoZSBkYXRlKSB0aGF0IHRoZSByZW50YWwgc3RhcnRlZC4gTWFrZSB0aGUgZm9sbG93aW5nIHBsb3RzIGFuZCBpbnRlcnByZXQgdGhlbToNCg0KICA3LiBBIGRlbnNpdHkgcGxvdCwgd2hpY2ggaXMgYSBzbW9vdGhlZCBvdXQgaGlzdG9ncmFtLCBvZiB0aGUgZXZlbnRzIHZlcnN1cyBgc2RhdGVgLiBVc2UgYGdlb21fZGVuc2l0eSgpYC4NCiAgDQpgYGB7cn0NClRyaXBzICU+JSANCiAgZ2dwbG90KGFlcyh4ID0gc2RhdGUpKSsNCiAgZ2VvbV9kZW5zaXR5KCkNCmBgYA0KICANCiAgOC4gQSBkZW5zaXR5IHBsb3Qgb2YgdGhlIGV2ZW50cyB2ZXJzdXMgdGltZSBvZiBkYXkuICBZb3UgY2FuIHVzZSBgbXV0YXRlKClgIHdpdGggYGx1YnJpZGF0ZWAncyAgYGhvdXIoKWAgYW5kIGBtaW51dGUoKWAgZnVuY3Rpb25zIHRvIGV4dHJhY3QgdGhlIGhvdXIgb2YgdGhlIGRheSBhbmQgbWludXRlIHdpdGhpbiB0aGUgaG91ciBmcm9tIGBzZGF0ZWAuIEhpbnQ6IEEgbWludXRlIGlzIDEvNjAgb2YgYW4gaG91ciwgc28gY3JlYXRlIGEgdmFyaWFibGUgd2hlcmUgMzozMCBpcyAzLjUgYW5kIDM6NDUgaXMgMy43NS4NCiAgDQpgYGB7cn0NClRyaXBzICU+JQ0KICBtdXRhdGUoaG91ciA9IGhvdXIoc2RhdGUpLCBtaW51dGUgPSBtaW51dGUoc2RhdGUpLA0KICAgICAgICAgdGltZV9vZl9kYXkgPSBob3VyICsgbWludXRlLzYwKSAlPiUgDQogIGdncGxvdChhZXMoeD0gdGltZV9vZl9kYXkpKSsNCiAgZ2VvbV9kZW5zaXR5KCkNCmBgYA0KICANCiAgOS4gQSBiYXIgZ3JhcGggb2YgdGhlIGV2ZW50cyB2ZXJzdXMgZGF5IG9mIHRoZSB3ZWVrLiBQdXQgZGF5IG9uIHRoZSB5LWF4aXMuDQogIA0KYGBge3J9DQpUcmlwcyAlPiUgDQogIG11dGF0ZShkYXkgPSB3ZWVrZGF5cyhzZGF0ZSkpICU+JSANCiAgZ2dwbG90KGFlcyh5PWRheSkpKw0KICBnZW9tX2JhcigpDQpgYGANCiAgDQogIDEwLiBGYWNldCB5b3VyIGdyYXBoIGZyb20gZXhlcmNpc2UgOC4gYnkgZGF5IG9mIHRoZSB3ZWVrLiBJcyB0aGVyZSBhIHBhdHRlcm4/DQogIA0KYGBge3J9DQpUcmlwcyAlPiUNCiAgbXV0YXRlKGhvdXIgPSBob3VyKHNkYXRlKSwgbWludXRlID0gbWludXRlKHNkYXRlKSwNCiAgICAgICAgIHRpbWVfb2ZfZGF5ID0gaG91ciArIG1pbnV0ZS82MCwNCiAgICAgICAgIGRheSA9IHdlZWtkYXlzKHNkYXRlKSkgJT4lIA0KICBnZ3Bsb3QoYWVzKHg9IHRpbWVfb2ZfZGF5KSkrDQogIGdlb21fZGVuc2l0eSgpKw0KICBmYWNldF93cmFwKHZhcnMoZGF5KSkNCmBgYA0KICANCiAqKk9uIHNhdHVyZGF5IGFuZCBzdW5kYXksIHRoZXJlIGlzIG1vcmUgYWN0aXZpdHkgZHVyaW5nIHRoZSBtaWRkbGUgb2YgdGhlIGRheSwgdnMgdGhlIHdlZWtkYXlzIGhhdmUgYSBsdWxsIGluIGJ1c2luZXNzIGR1cmluZyB0aGF0IHNhbWUgdGltZSoqDQogDQpUaGUgdmFyaWFibGUgYGNsaWVudGAgZGVzY3JpYmVzIHdoZXRoZXIgdGhlIHJlbnRlciBpcyBhIHJlZ3VsYXIgdXNlciAobGV2ZWwgYFJlZ2lzdGVyZWRgKSBvciBoYXMgbm90IGpvaW5lZCB0aGUgYmlrZS1yZW50YWwgb3JnYW5pemF0aW9uIChgQ2F1c2FsYCkuIFRoZSBuZXh0IHNldCBvZiBleGVyY2lzZXMgaW52ZXN0aWdhdGUgd2hldGhlciB0aGVzZSB0d28gZGlmZmVyZW50IGNhdGVnb3JpZXMgb2YgdXNlcnMgc2hvdyBkaWZmZXJlbnQgcmVudGFsIGJlaGF2aW9yIGFuZCBob3cgYGNsaWVudGAgaW50ZXJhY3RzIHdpdGggdGhlIHBhdHRlcm5zIHlvdSBmb3VuZCBpbiB0aGUgcHJldmlvdXMgZXhlcmNpc2VzLiBSZXBlYXQgdGhlIGdyYXBoaWMgZnJvbSBFeGVyY2lzZSBcQHJlZihleHI6ZXhyLXRlbXApIChkKSB3aXRoIHRoZSBmb2xsb3dpbmcgY2hhbmdlczoNCg0KICAxMS4gQ2hhbmdlIHRoZSBncmFwaCBmcm9tIGV4ZXJjaXNlIDEwIHRvIHNldCB0aGUgYGZpbGxgIGFlc3RoZXRpYyBmb3IgYGdlb21fZGVuc2l0eSgpYCB0byB0aGUgYGNsaWVudGAgdmFyaWFibGUuIFlvdSBzaG91bGQgYWxzbyBzZXQgYGFscGhhID0gLjVgIGZvciB0cmFuc3BhcmVuY3kgYW5kIGBjb2xvcj1OQWAgdG8gc3VwcHJlc3MgdGhlIG91dGxpbmUgb2YgdGhlIGRlbnNpdHkgZnVuY3Rpb24uDQogIA0KYGBge3J9DQpUcmlwcyAlPiUNCiAgbXV0YXRlKGhvdXIgPSBob3VyKHNkYXRlKSwgbWludXRlID0gbWludXRlKHNkYXRlKSwNCiAgICAgICAgIHRpbWVfb2ZfZGF5ID0gaG91ciArIG1pbnV0ZS82MCwNCiAgICAgICAgIGRheSA9IHdlZWtkYXlzKHNkYXRlKSkgJT4lIA0KICBnZ3Bsb3QoYWVzKHg9IHRpbWVfb2ZfZGF5LCBmaWxsID0gY2xpZW50LCBhbHBoYSA9IC41KSkrDQogIGdlb21fZGVuc2l0eShjb2xvciA9IE5BKSsNCiAgZmFjZXRfd3JhcCh2YXJzKGRheSkpDQpgYGANCg0KICAxMi4gQ2hhbmdlIHRoZSBwcmV2aW91cyBncmFwaCBieSBhZGRpbmcgdGhlIGFyZ3VtZW50IGBwb3NpdGlvbiA9IHBvc2l0aW9uX3N0YWNrKClgIHRvIGBnZW9tX2RlbnNpdHkoKWAuIEluIHlvdXIgb3BpbmlvbiwgaXMgdGhpcyBiZXR0ZXIgb3Igd29yc2UgaW4gdGVybXMgb2YgdGVsbGluZyBhIHN0b3J5PyBXaGF0IGFyZSB0aGUgYWR2YW50YWdlcy9kaXNhZHZhbnRhZ2VzIG9mIGVhY2g/DQogIA0KYGBge3J9DQpUcmlwcyAlPiUNCiAgbXV0YXRlKGhvdXIgPSBob3VyKHNkYXRlKSwgbWludXRlID0gbWludXRlKHNkYXRlKSwNCiAgICAgICAgIHRpbWVfb2ZfZGF5ID0gaG91ciArIG1pbnV0ZS82MCwNCiAgICAgICAgIGRheSA9IHdlZWtkYXlzKHNkYXRlKSkgJT4lIA0KICBnZ3Bsb3QoYWVzKHg9IHRpbWVfb2ZfZGF5LCBmaWxsID0gY2xpZW50LCBhbHBoYSA9IC41KSkrDQogIGdlb21fZGVuc2l0eShjb2xvciA9IE5BLCBwb3NpdGlvbiA9IHBvc2l0aW9uX3N0YWNrKCkpKw0KICBmYWNldF93cmFwKHZhcnMoZGF5KSkNCmBgYA0KICAqKg0KICAxMy4gQWRkIGEgbmV3IHZhcmlhYmxlIHRvIHRoZSBkYXRhc2V0IGNhbGxlZCBgd2Vla2VuZGAgd2hpY2ggd2lsbCBiZSAid2Vla2VuZCIgaWYgdGhlIGRheSBpcyBTYXR1cmRheSBvciBTdW5kYXkgYW5kICAid2Vla2RheSIgb3RoZXJ3aXNlIChISU5UOiB1c2UgdGhlIGBpZmVsc2UoKWAgZnVuY3Rpb24gYW5kIHRoZSBgd2RheSgpYCBmdW5jdGlvbiBmcm9tIGBsdWJyaWRhdGVgKS4gVGhlbiwgdXBkYXRlIHRoZSBncmFwaCBmcm9tIHRoZSBwcmV2aW91cyBwcm9ibGVtIGJ5IGZhY2V0aW5nIG9uIHRoZSBuZXcgYHdlZWtlbmRgIHZhcmlhYmxlLiANCiAgDQpgYGB7cn0NClRyaXBzICU+JSANCiAgbXV0YXRlKGhvdXIgPSBob3VyKHNkYXRlKSwgbWludXRlID0gbWludXRlKHNkYXRlKSwNCiAgICAgICAgIHRpbWVfb2ZfZGF5ID0gaG91cihzZGF0ZSkgKyBtaW51dGUvNjAsDQogICAgICB3ZWVrX2RheSA9IHdkYXkoc2RhdGUsIGxhYmVsID0gVFJVRSksDQogICAgICB3ZWVrZW5kID0gaWZlbHNlKHdlZWtfZGF5ID09IGMoIlNhdCIsICJTdW4iKSwgICAiV2Vla2VuZCIsIldlZWtkYXkiICkpICU+JSANCiAgZ2dwbG90KGFlcyh4ID0gdGltZV9vZl9kYXksIGZpbGwgPSBjbGllbnQsIGFscGhhID0gLjUpKSsNCiAgZ2VvbV9kZW5zaXR5KGNvbG9yID0gTkEpKw0KICBmYWNldF93cmFwKHZhcnMod2Vla2VuZCkpDQogIA0KYGBgDQogIA0KICAxNC4gQ2hhbmdlIHRoZSBncmFwaCBmcm9tIHRoZSBwcmV2aW91cyBwcm9ibGVtIHRvIGZhY2V0IG9uIGBjbGllbnRgIGFuZCBmaWxsIHdpdGggYHdlZWtkYXlgLiBXaGF0IGluZm9ybWF0aW9uIGRvZXMgdGhpcyBncmFwaCB0ZWxsIHlvdSB0aGF0IHRoZSBwcmV2aW91cyBkaWRuJ3Q/IElzIG9uZSBncmFwaCBiZXR0ZXIgdGhhbiB0aGUgb3RoZXI/DQogIA0KYGBge3J9DQpUcmlwcyAlPiUgDQogIG11dGF0ZShob3VyID0gaG91cihzZGF0ZSksIG1pbnV0ZSA9IG1pbnV0ZShzZGF0ZSksDQogICAgICAgICB0aW1lX29mX2RheSA9IGhvdXIoc2RhdGUpICsgbWludXRlLzYwLA0KICAgICAgd2Vla19kYXkgPSB3ZGF5KHNkYXRlLCBsYWJlbCA9IFRSVUUpLA0KICAgICAgd2Vla2VuZCA9IGlmZWxzZSh3ZWVrX2RheSA9PSBjKCJTYXQiLCAiU3VuIiksICAgIldlZWtlbmQiLCJXZWVrZGF5IiApKSAlPiUgDQogIGdncGxvdChhZXMoeCA9IHRpbWVfb2ZfZGF5LCBmaWxsID0gd2Vla19kYXksIGFscGhhID0gLjUpKSsNCiAgZ2VvbV9kZW5zaXR5KGNvbG9yID0gTkEpKw0KICBmYWNldF93cmFwKHZhcnMoY2xpZW50KSkNCmBgYA0KICANCiAqKiBUaGlzIGdyYXBoIHRlbGxzIHVzIHRoZSBzcGVjaWZpYyBkYXkgaW4gd2hpY2ggY2FzdWFsL3JlZ2lzdGVyZWQgcmVudGVycyByZW50IGEgYmlrZSwgd2hlcmUgdGhlIHByZXZpb3VzIGdyYXBoIGdhdmUgdXMgZ2VuZXJhbCAnd2Vla2VuZCcgYW5kICd3ZWVrZGF5Jy4gVGhlIHNlY29uZCBncmFwaCBpcyBhIGJpdCBoYXJkIHRvIHJlYWQgc2luY2UgdGhlIGNvbG9ycyBhcmUgYWxsIG11ZGRsZWQgdG9nZXRoZXIsIGJ1dCBJIHRoaW5rIGl0IGRlcGVuZHMgb24gaG93IHNwZWNpZmljIHlvdSB3YW50IHlvdXIgZGF0YSB0byBiZSBwcmVzZW50ZWQuIEkgd291bGQgdXNlIGJvdGggb2YgdGhlc2UgZ3JhcGhzLCBidXQgcGVyaGFwcyBmb3IgZGlmZmVyZW50IHF1ZXN0aW9ucy4qKg0KICANCiMjIyBTcGF0aWFsIHBhdHRlcm5zDQoNCiAgMTUuIFVzZSB0aGUgbGF0aXR1ZGUgYW5kIGxvbmdpdHVkZSB2YXJpYWJsZXMgaW4gYFN0YXRpb25zYCB0byBtYWtlIGEgdmlzdWFsaXphdGlvbiBvZiB0aGUgdG90YWwgbnVtYmVyIG9mIGRlcGFydHVyZXMgZnJvbSBlYWNoIHN0YXRpb24gaW4gdGhlIGBUcmlwc2AgZGF0YS4gVXNlIGVpdGhlciBjb2xvciBvciBzaXplIHRvIHNob3cgdGhlIHZhcmlhdGlvbiBpbiBudW1iZXIgb2YgZGVwYXJ0dXJlcy4gV2Ugd2lsbCBpbXByb3ZlIHRoaXMgcGxvdCBuZXh0IHdlZWsgd2hlbiB3ZSBsZWFybiBhYm91dCBtYXBzIQ0KICANCmBgYHtyfQ0KU3RhdGlvbnMgJT4lIA0KICBsZWZ0X2pvaW4oVHJpcHMsDQogICAgICAgICAgICBieSA9IGMoIm5hbWUiID0gInNzdGF0aW9uIikpICU+JSANCiAgZ3JvdXBfYnkobmFtZSxsb25nLCBsYXQpICU+JSANCiAgc3VtbWFyaXplKGNvdW50ID0gbigpKSAlPiUgDQogIGdncGxvdChhZXMoeCA9IGxhdCwgeSA9IGxvbmcsIGNvbG9yID0gY291bnQsIHNpemUgPSBjb3VudCkpKw0KICBnZW9tX3BvaW50KCkNCiANCmBgYA0KICANCiAgMTYuIE9ubHkgMTQuNCUgb2YgdGhlIHRyaXBzIGluIG91ciBkYXRhIGFyZSBjYXJyaWVkIG91dCBieSBjYXN1YWwgdXNlcnMuIENyZWF0ZSBhIHBsb3QgdGhhdCBzaG93cyB3aGljaCBhcmVhKHMpIGhhdmUgc3RhdGlvbnMgd2l0aCBhIG11Y2ggaGlnaGVyIHBlcmNlbnRhZ2Ugb2YgZGVwYXJ0dXJlcyBieSBjYXN1YWwgdXNlcnMuIFdoYXQgcGF0dGVybnMgZG8geW91IG5vdGljZT8gKEFnYWluLCB3ZSdsbCBpbXByb3ZlIHRoaXMgbmV4dCB3ZWVrIHdoZW4gd2UgbGVhcm4gYWJvdXQgbWFwcykuDQogIA0KYGBge3J9DQpTdGF0aW9ucyAlPiUgDQogIGxlZnRfam9pbihUcmlwcywNCiAgICAgICAgICAgIGJ5ID0gYygibmFtZSIgPSAic3N0YXRpb24iKSkgJT4lIA0KICBncm91cF9ieShuYW1lLCBsb25nLCBsYXQpICU+JSANCiAgc3VtbWFyaXplKHBlcmNlbnRfY2FzdWFsID0gbWVhbihjbGllbnQgPT0gIkNhc3VhbCIpKSAlPiUgDQogIGdncGxvdChhZXMoeCA9IGxvbmcsIA0KICAgICAgICAgICAgIHkgPSBsYXQsIA0KICAgICAgICAgICAgIGNvbG9yID0gcGVyY2VudF9jYXN1YWwpKSsNCiAgZ2VvbV9wb2ludCgpDQpgYGANCiAgDQojIyMgU3BhdGlvdGVtcG9yYWwgcGF0dGVybnMNCg0KICAxNy4gTWFrZSBhIHRhYmxlIHdpdGggdGhlIHRlbiBzdGF0aW9uLWRhdGUgY29tYmluYXRpb25zIChlLmcuLCAxNHRoICYgViBTdC4sIDIwMTQtMTAtMTQpIHdpdGggdGhlIGhpZ2hlc3QgbnVtYmVyIG9mIGRlcGFydHVyZXMsIHNvcnRlZCBmcm9tIG1vc3QgZGVwYXJ0dXJlcyB0byBmZXdlc3QuIFNhdmUgdGhpcyB0byBhIG5ldyBkYXRhc2V0IGFuZCBwcmludCBvdXQgdGhlIGRhdGFzZXQuIEhpbnQ6IGBhc19kYXRlKHNkYXRlKWAgY29udmVydHMgYHNkYXRlYCBmcm9tIGRhdGUtdGltZSBmb3JtYXQgdG8gZGF0ZSBmb3JtYXQuIA0KICANCmBgYHtyfQ0KdG9wX3N0YXRpb25zIDwtIFN0YXRpb25zICU+JSANCiAgbGVmdF9qb2luKFRyaXBzLA0KICAgICAgICAgICAgYnkgPSBjKCJuYW1lIiA9ICJzc3RhdGlvbiIpKSAlPiUgDQogIG11dGF0ZShzZGF0ZSA9IGFzX2RhdGUoc2RhdGUpKSAlPiUgDQogIGdyb3VwX2J5KG5hbWUsIHNkYXRlKSAlPiUgDQogIHN1bW1hcml6ZShjb3VudCA9IG4oKSkgJT4lIA0KICBhcnJhbmdlKGRlc2MoY291bnQpKSAlPiUgDQogIGhlYWQobiA9IDEwKQ0KICANCmBgYA0KICANCiAgMTguIFVzZSBhIGpvaW4gb3BlcmF0aW9uIHRvIG1ha2UgYSB0YWJsZSB3aXRoIG9ubHkgdGhvc2UgdHJpcHMgd2hvc2UgZGVwYXJ0dXJlcyBtYXRjaCB0aG9zZSB0b3AgdGVuIHN0YXRpb24tZGF0ZSBjb21iaW5hdGlvbnMgZnJvbSB0aGUgcHJldmlvdXMgcGFydC4NCiAgDQpgYGB7cn0NCnRvcF9zdGF0aW9ucyAlPiUgDQogIGlubmVyX2pvaW4oVHJpcHMsDQogICAgICAgICAgICAgYnkgPSBjKCJuYW1lIiA9ICJzc3RhdGlvbiIpKQ0KYGBgDQogIA0KICAxOS4gQnVpbGQgb24gdGhlIGNvZGUgZnJvbSB0aGUgcHJldmlvdXMgcHJvYmxlbSAoaWUuIGNvcHkgdGhhdCBjb2RlIGJlbG93IGFuZCB0aGVuICU+JSBpbnRvIHRoZSBuZXh0IHN0ZXAuKSBhbmQgZ3JvdXAgdGhlIHRyaXBzIGJ5IGNsaWVudCB0eXBlIGFuZCBkYXkgb2YgdGhlIHdlZWsgKHVzZSB0aGUgbmFtZSwgbm90IHRoZSBudW1iZXIpLiBGaW5kIHRoZSBwcm9wb3J0aW9uIG9mIHRyaXBzIGJ5IGRheSB3aXRoaW4gZWFjaCBjbGllbnQgdHlwZSAoaWUuIHRoZSBwcm9wb3J0aW9ucyBmb3IgYWxsIDcgZGF5cyB3aXRoaW4gZWFjaCBjbGllbnQgdHlwZSBhZGQgdXAgdG8gMSkuIERpc3BsYXkgeW91ciByZXN1bHRzIHNvIGRheSBvZiB3ZWVrIGlzIGEgY29sdW1uIGFuZCB0aGVyZSBpcyBhIGNvbHVtbiBmb3IgZWFjaCBjbGllbnQgdHlwZS4gSW50ZXJwcmV0IHlvdXIgcmVzdWx0cy4NCiAgKipJJ20gc29ycnksIEkgZGlkbid0IGtub3cgaG93IHRvIGRvICMxOCwgc28gdGhpcyBxdWVzdGlvbiB0cmlwcGVkIG1lIHVwIGFzIHdlbGwuKioNCg0KKipESUQgWU9VIFJFTUVNQkVSIFRPIEdPIEJBQ0sgQU5EIENIQU5HRSBUSElTIFNFVCBPRiBFWEVSQ0lTRVMgVE8gVEhFIExBUkdFUiBEQVRBU0VUPyBJRiBOT1QsIERPIFRIQVQgTk9XLioqDQoNCiMjIEdpdEh1YiBsaW5rDQoNCiAgMjAuIEJlbG93LCBwcm92aWRlIGEgbGluayB0byB5b3VyIEdpdEh1YiBwYWdlIHdpdGggdGhpcyBzZXQgb2YgV2Vla2x5IEV4ZXJjaXNlcy4gU3BlY2lmaWNhbGx5LCBpZiB0aGUgbmFtZSBvZiB0aGUgZmlsZSBpcyAwM19leGVyY2lzZXMuUm1kLCBwcm92aWRlIGEgbGluayB0byB0aGUgMDNfZXhlcmNpc2VzLm1kIGZpbGUsIHdoaWNoIGlzIHRoZSBvbmUgdGhhdCB3aWxsIGJlIG1vc3QgcmVhZGFibGUgb24gR2l0SHViLg0KDQojIyBDaGFsbGVuZ2UgcHJvYmxlbSEgDQoNClRoaXMgcHJvYmxlbSB1c2VzIHRoZSBkYXRhIGZyb20gdGhlIFRpZHkgVHVlc2RheSBjb21wZXRpdGlvbiB0aGlzIHdlZWssIGBraWRzYC4gSWYgeW91IG5lZWQgdG8gcmVmcmVzaCB5b3VyIG1lbW9yeSBvbiB0aGUgZGF0YSwgcmVhZCBhYm91dCBpdCBbaGVyZV0oaHR0cHM6Ly9naXRodWIuY29tL3Jmb3JkYXRhc2NpZW5jZS90aWR5dHVlc2RheS9ibG9iL21hc3Rlci9kYXRhLzIwMjAvMjAyMC0wOS0xNS9yZWFkbWUubWQpLiANCg0KICAyMS4gSW4gdGhpcyBleGVyY2lzZSwgeW91IGFyZSBnb2luZyB0byB0cnkgdG8gcmVwbGljYXRlIHRoZSBncmFwaCBiZWxvdywgY3JlYXRlZCBieSBHZW9yZ2lvcyBLYXJhbWFuaXMuIEknbSBzdXJlIHlvdSBjYW4gZmluZCB0aGUgZXhhY3QgY29kZSBvbiBHaXRIdWIgc29tZXdoZXJlLCBidXQgKipET04nVCBETyBUSEFUISoqIFlvdSB3aWxsIG9ubHkgYmUgZ3JhZGVkIGZvciBwdXR0aW5nIGFuIGVmZm9ydCBpbnRvIHRoaXMgcHJvYmxlbS4gU28sIGdpdmUgaXQgYSB0cnkgYW5kIHNlZSBob3cgZmFyIHlvdSBjYW4gZ2V0IHdpdGhvdXQgZG9pbmcgdG9vIG11Y2ggZ29vZ2xpbmcuIEhJTlQ6IHVzZSBgZmFjZXRfZ2VvKClgLiBUaGUgZ3JhcGhpYyB3b24ndCBsb2FkIGJlbG93IHNpbmNlIGl0IGNhbWUgZnJvbSBhIGxvY2F0aW9uIG9uIG15IGNvbXB1dGVyLiBTbywgeW91J2xsIGhhdmUgdG8gcmVmZXJlbmNlIHRoZSBvcmlnaW5hbCBodG1sIG9uIHRoZSBtb29kbGUgcGFnZSB0byBzZWUgaXQuDQogIA0KDQoNCioqRElEIFlPVSBSRU1FTUJFUiBUTyBVTkNPTU1FTlQgVEhFIE9QVElPTlMgQVQgVEhFIFRPUD8qKg0K